From 006b473c0cff1a91396a0ce42150c4ec15af2bab Mon Sep 17 00:00:00 2001
From: =?utf8?q?Luk=C3=A1=C5=A1=20Tyrychtr?= <lukastyrychtr@gmail.com>
Date: Thu, 15 Sep 2022 18:09:53 +0200
Subject: [PATCH] Improve documentation

---
 gtk/gtkaccessiblerange.c |  4 ++++
 gtk/gtkaccessiblerange.h | 17 +++++++++++++++++
 2 files changed, 21 insertions(+)

diff --git a/gtk/gtkaccessiblerange.c b/gtk/gtkaccessiblerange.c
index 363e954515..7593012cf2 100644
--- a/gtk/gtkaccessiblerange.c
+++ b/gtk/gtkaccessiblerange.c
@@ -32,6 +32,10 @@
  * In addition to this interface, its implementors are expected to provide the
  * correct values for the following properties: %GTK_ACCESSIBLE_PROPERTY_VALUE_MAX,
  * %GTK_ACCESSIBLE_PROPERTY_VALUE_MIN and %GTK_ACCESSIBLE_PROPERTY_VALUE_NOW.
+ * 
+ * For controls where a minimum increment makes no sense and which do not allow
+ * setting the current value from the user, the default implementation of this
+ * interface suffices.
  */
 
 #include "config.h"
diff --git a/gtk/gtkaccessiblerange.h b/gtk/gtkaccessiblerange.h
index 45ffefc257..55da3d688c 100644
--- a/gtk/gtkaccessiblerange.h
+++ b/gtk/gtkaccessiblerange.h
@@ -37,7 +37,24 @@ struct _GtkAccessibleRangeInterface
 {
   GTypeInterface g_iface;
 
+  /**
+   * GtkAccessibleRangeInterface::get_minimum_increment:
+   * @self: a `GtkAccessibleRange`
+   * 
+   * Returns the minimum increment for this `GtkAccessibleRange`.
+   * The default implementation returns 0.0, which indicates that a minimum
+   * increment does not make sense for this implementation.
+   * @returns: the minimum increment
+   */
   double (* get_minimum_increment) (GtkAccessibleRange *self);
+  /**
+   * GtkAccessibleRangeInterface::set_current_value:
+   * @self: a `GtkAccessibleRange`
+   * @value: the value to set
+   * 
+   * Sets the current value of @self to @value.
+   * This operation should behave similarly as if the user performed the action.
+   */
   void (* set_current_value) (GtkAccessibleRange *self, double value);
 };
 
-- 
2.30.2